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DOS DEVICE DRIVER - MT8 


1 Overview 
1.1 Deecription 


The Overland Data DOS Device Driver is an installable, 
"character" type device driver which provides the ability to _ 
read, write and position nine track tape drives with minimal } 
level coding. Nevertheless, a tepe drive is not a disk and can 
use the built in DOS commands. Tape drives have no directory anu 
and are not randoswp access devices. They are designed for optiaal 
operation in sequential read or write applications. 

This device driver is designed to provide buffered, sultiple 
block tape capability with ainisgel overhead. Moreover, buffering 
of up to 64k bytes can be specified where high performance 
operations are desired. The driver provides variable block sizes 
in both read and write of up to Skb with up to 32k supported with 
the larger buffer configuration. 

The nave of the tape device driver 1s "MT#@". Like the line 
printer "PRN", the tape driver.is referred to by the name "MTS". 


1.2 Application 


The device driver reads and writes blocks of sizes fros 
1-32k but when a block size of 8 bytes is read, this indicates 
that a file mark has been detected. The device driver will 
continue to read 8 bytes until the device is closed. Data after 
the file mark can be read by re opening the tape drive, selecting 
binery mode through an IOCTL call, and issuing more read 
commands. 

An extended commend set allows control over tape positio: 
at a fine level. Records and files may be positioned forward c 
reverse and tape may be rewound or positioned at the logical ena 
of tape (Between the 2 consecutive file marks which mark logical 


end of data). These commands are issued through IOCTL strings of 
2 bytes each. For instance, "F+" means skip forward one file 
@ark. and "R-" seans backspace one record. 


1.3 Installation 


The installation of the tape driver :s consistent with other 
drivers such as AWS].SYS. The tape driver is installed by adding 
the line: 


device tape mt®@.sys nn 


The driver say be tailored to the users system by specifying an 
optional buffer size argument, "nn". This argument ranges from @ 
to 64 and specifies the number of Kbytes of data buffering by the 
driver. 8 Kb is the esinieusa, If 1 through 7 Kb are specified, 8 
Kb is set. If no argument exists or it is 8, buffering is set for 
the remainder of the 64k hardware boundary which the driver 18 
loaded in. This provides the best smepory utilization since no 
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memory is wasted to avoid hardware boundary wrap. (dwa in the IBM 
PC and clones pay not overlap a 64k hardware boundary due to the 
use of a 16 bit dwa chip (8237) and separate page register. 


1.4 Reference Material 


For maximum use of the device driver, the reference work DOS 

ical Reference is essential. This describes the operation of 
L the DOS functions as well as device driver isplesentations. 
Within the examples and descriptions, references will be made to 
this volume. 


In particular, open, read, write, and ioctl functions should be 
reviewed. 


FUNCTION PAGE 
OPEN 6-118 
CLOSE 6-122 
READ 6-123 
WRITE 6-125 
IOCTL 6-132 


2 Using a DOS Character Device 
2.1 Tape Usage Convention 


Logically, tape is best viewed as a series of blocks of variable 
lengths separated by gaps which allow the drive to distinguish 
one block from another. These data blocks start at BOT (beginning 
€ pe) and continue no wore than a few feet past EOT(end of 
. BOT and EOT are actually reflective strips that are 

a.  -ched to the backside of the tape within prescribed ranges of 
actual ends of the tape. The capacity of tape is determined by a 
combination of tape density, reel size, tape thickness, and block 
size. For details on this see the transport manual provided with 
the tape drive. 


Tapes have very special blocks called file werks. These records 
of block size 8 are used to demarcate files. By convention, 2 
consecutive file werks indicate a logical end of all data on 
tape. Reading past this point has no meaning and will give 
unpredictable results. When writing tapes care must be taken to 
always ensure these 2 file marks are recorded prior to rewinding. 


2.2 Selecting a Binary Mode 
The process of selection of binary mode is straightforward and 


needs only to be done once, ismediately after opening the tape 
device. It is required since an installed non-disk device is 
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assumed (rashly) to be an ascii device like a printer. Automatic 
conversions of carriage return and other control codes are done 
which make the default mode useless with tape. The Process is: 


Open the device with function 3DH. Get the IOCTL status by 
calling function 44H with AL=8 and BX-handle. Clear DH and set 
the binary.smode bit by OR’ing 28H with DL. Set AL to 1 and cal’ 
function 44H again. This sequence sets the binary mode. Read or 
write calls can now be issued. 


2.3 Reading Blocks 


When reading blocks, use function 3FH. Always use a buffer ‘and 
count size sufficient for the largest block which may be on tape. 
A request to read a block which is larger than the i/o buffer 
will result in an i/o error. On return AX contains the actual 
number of bytes read in that block. It will always be equal to or 
smaller than the requested block size. 


If AX returns 98 from a read, then end of file is detected (a file 
mark) and the driver will continue to return 98 length without 
tape motion until the device is closed (function 3EH). To read 
past this file mark, simply reopen the tape driver, reset the 
binary mode and continue. 


2.4 Writing Blocks 


When writing blocks, use function 46H. DS:DX points to the start 
of a byte array containing the data to be written. CX contains 
the count of a number of bytes to write. After each write you 
will not neccessarily see tape motion. the data is buffered to 
operate the tape drive more efficiently and improve throughput. 
It is required to write the necessary file marks to indicate end 
of tape after the last data block is written. This is done by a 
write dos call with CX set to OFFFFH. All data which is buffered 
is written followed by two file marks. The tape drive is then 
positioned between the two file marks allowing the driver to be 
closed and reopened. More writes eliminate the second file sark 
and this technique allows aultiple files, each of sany records, 
to be written on one tape. 


2.5 Completing Tape Usage 


There is a special program included which allows dos command line 
clesing and rewinding of a tape drive. executing TAPE R- will 
write out any buffered writes, write two file marks if the tape 
was previously writing, and rewind the tape. By ALWAYS using this 
program to finish tape drive usage, you will avoid potential data 
loss. 
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ha et A hh aE 


IMPORTANT: NEVER REWIND THE TAPE DRIVE MANUALLY 


3 IOCTL Bxtended Commands 


3.1 Using the IOCTL commands 


extended function cowmands are implemented vie the IOCTL call 
function 44H, AL=3, CX=2, BX=tape handle) This function 

wiites a control string to the driver which contains a tape 
positioning command. If the tape is in the write mode, the data 
buffers are first flushed to tape and a logical end is written (2 
file marks). The first letter of this command specifies the scope 
of the operation, the second character specifies the direction of 
the command. 


3.2 “T6" - Close Tape Drive Operation 


The current tape functions are completed. In the write mode the 
tape buffers are flushed to tape, 2 file marks are appended, and 
the tape is repositioned between the two file marks. This would 
allow the tape to write another file of data by re-opening the 
tape for writing. 


3.3 “T-" - Close and Rewind Tape Drive 
This command is the sage as the close command except that the 
tape is rewound. This is the usual finishing command for a 

«ram that uses tape. 
3.4 "T+" - Skip Forward to Logical End of Tape 
This command can be used prior to any tape operation to position 
the tape at the logical end of tape. Tape is skipped to 2 
consecutive file marks are detected and then repositioned between 
then. 
3.5 “F+" - Skip Next File Mark 
This skips to the next file mark. It is a way to terminate the 
reading of a current file and skip to the start of the next file. 
3.6 “p-" - Skip Reverse to Last File Mark 
This skipe reverse a file mark. Since it leaves the tape before 


the file mark which demarcates the current file it should be 
followed with a skip forward file command. 
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3.7 "FW" - Write a File Mark at Current Location 


This command writes a file mark at the current location. It's use 
should be restricted in favor of the standard closing mechanism 
for marking files. 





3.8 "R+" - Skip a Block 


Skipping a block is a high speed way to space over data blocks 
which are to be ignored. Since no date is transferred, no buffer 
has to be allocated. 


3.9 “R-" - Skip Reverse a Block 


This is eae way to force rereading of a block. Normally each read 
positions a block further down tape. This allows a block to be 
read over again. 


3.18 “RO" - Erase a Fixed Tape Gap 


This Command erases a block of data. It is provided for 
diagnostic considerations and it’s use not recommended. Generally 
used for erasing data blocks written in error (bad tape spots), 
it has little value here since bad spots are automatically 
rewritten by the tape driver tape _at8.sys. 
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Sample Driver Code for Various High Level Languages 
Cc" Microsoft 3.0 


- TAPE.C - The TAPE program 


ee es Ll 11/14/25 +*/ 


stdio ti) 
(dos > 


extern errno; 


main(arac, araqv) 





int arqc; 

char *€araqv: 

{ 

int i, fd; 

union REGS in, out; 


imn.x.dx = (unsiqned) "“MTO"; /* open the tape drive device +*/ 
in.x.ax = Ox3dn2: /* open dos codes 4/ 
intdos(&in, &auut); /* dos call to apen ¥*/ 


if (out.x.cflag){ 
perror ("Can't open device mtQ: "); 
exit (1); 


} 
fd = out.x.ax; /* file descriptor of tape ¢/ 
im.x.ax = 0x4403; /* write ioctl string €/ 
in.x.bx = fd; 
“HM .X.CK = 2; /* transter 2 bytes ¢/ 

‘-tremp(arav[il, “rewind") <== 0) 

—.x.dx = (umsigned)"“t “; /* code for close and rewind +/ 
f (stremp(araqvi[ lL], "“close”)  -. O) 
in.x.dx = (umsiqned) “to”; /* code for close +¢/ 

2 if ((stremp(arqvil], “to") == oO) ft /* close and rewind +¢/ 
(stremp(aravi] ij, “t#") == Oo) ft /* ao to end of tetcorded data * 
(stremp(arav[ lL], "t-") =- O) t3 /* rewind to start of tape +¢/ 
(strcemp(araqv[1], "rt+") -- O) 43 /* apace forward 1 record ¢/ 
(strcempl(araqv[ i], “"r-") =. O) Th /* space reverse Ll recard ¢/ 
(strcemp(arqvyp i], "“rw") =: 0) Gt /*+ erase 4° gap of tape +*/ 
(stremp(aravf[1], “ft+") -= 0) tt /*# skip past next file mark ¢+¢/ 
(strcmplarav[I], “f-") =. O)8 44 /* backup past last file mark + 
(strcmp(arqv[1l], “fw") == O))f /* write a file mark +/ 

in.x.dx = (umsiqned)aravi1]; 
} 
elsef{ 
printf ("Usaqe: tape rewindicloce:rtOitiitcif tif: tfwie ter cro rn); 
exit(-1); 
} 
intdos(&imn, S&out); /* do an ioctl] to act “status +/ 


} 
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4.1.2 SAMPLEIO.C - Sample Disk to Tape Copy 


/* €4(#)sampleio.c 1? 11/14/85 +*/ 





#include <fentl .hD> 
#include <sys/types.h> 
#include <(sys/stat..h) 
#include (stdio.h> 
#ineclude <dos ty 


/ ¢: 

** SAMPLE CODE DEMOSTRATING THE USE OF THE Duos DRIVER FOR TAPE 
** READING AND WRITING 

«+ 

**€ LISAGE - 

+ ¢ TAPECOPY FILESPEC TO MTO 

+ TAPECOPY MTU TO FILESPEC 

+e 

*¥ DOS COMPILE: Cl -O -o tapecopy.exe samplio.c 


tt 
** programmer mq 
*¥ sccs path: files/dos/driver 





*/ 
main(arac, argv) 
int. argc: 
char *¥*arav; 
{ 
if (argc !. 4 1: strempi(arqv[2], “to") t= 0) 
usage (); 
if (strempidaravi[ Ij. “mto") =: a){ /* tape to file copy */ 
tape to file(argv[3]); 
) 
else af (strcempi(argv[3], “mto") == O)f /* file to tape cof 
file to _tape(arav[1]); 
else 
usage (); 
} 
usage (){ | 
prantf ("Usage: tapecopy filename to mtQ OR tapecapy mtO to filename 
exit( 1): 
} 
unsigned char tape tutfer[27o4ae)]: /+ data buffer for i/o * 
tape to file(file) /* copy tape to disk fil: 
char *file; 
{ 
imt cmt: 
f dt open (°mt.o", Cc BINARY | © RDWR); /* open the tape driver 


if (fdt « OM 
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perror ("Unable to open tape drive: "); 
exit(1); 
} 

moin made (fdt.); 





df = unlink(file); 
sen disk file for writing */ 
open(file, © _BTNARY | OG _WRONLY | ©.CREAT, S_IRFAD : S_IWRITL); 


/* remove existing disk file ¥/ 


w...2e ((cnt = read(fdt, tape buffer, 2048))'> O)f 
write(fdt, tape buffer, cnt); 
} 
if (emt '= of 
perror("Error capying tape to file “); 
exit (-1); 
} 
io control (fdt. “t-"); /* close and rewind tape */ 
} 
file to_tape(file) 
char *file; 
{ 
int fdt, fdf; 
int cnt; 
fdt. = apen("“mtO", GO BINARY ! O_RDWR): /* open the tape driver +/ 
if (fdt « a)f{ 
perror (“Unable to open tape drive: "); 
exit(l); 


} 
hin_mode(fdt); 





open(file, O BINARY | O_RDONLY); 


. .2e ((cnt = read(fdf, tape_buffer, 2049)) > o)f 
write(fdt, tape buffer, cnt); 


} 
if (cnt t= o)f{ 
perror(“trror copying file to tape "); 
exit(-1); 
} 
10_control(fdt, “t-"); /* close and rewind tape */ 


} 


/* 


«* this routine sets the i/o device represented by handle ‘fd 
*«* to binary mode. Required to make tape i/o useful. 


«/ 

2in_mode-( fd) 
register fd; 
{ 
union REGS in, out; /* defined in <dos.h> ¥*/ 
in.x.ax = Ox4400; /* read ioctl for binary */ 
in.x.bx = fd; /* handle to make binary */ 
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intdos(&in, Gout); /* read ioctl status +/ 

in.tr.dh = ©; /* set tKiah order byte ta oO ¥/ 
in.-hW#.dl zout.hodl i Ox2u; /*+ set bit indicating binary mode 
im.x.ax = Ox4401; /* set ioctl] statu. command */ 
intdas(&in, &out); 

t 


/* output ioctl string to file handle */ 
io control (fd, str) 

reaister fd; 

reqister char *str; 


union REGS in, out; 


in.x.ax = O0x4403; /* ioctl for output control strir 
in.x.bx - fd; /* handle +/ 

in.x.cx = strlen(str); /* Jenath af string */ 

im.x.dx = (umsigqned) str; /* clase and rewind code ¥/ 
intdos(&in, G&cut.): 

} 


4.2 Turbo Pascal 3.0 
4.2.1 TAPEWRIT - Sample Program 


{ 
TAPEWRTT 
Sample tape driver program for Turbo Pascal 
This prpgram write 10 blocks of 2948 bytes each. 
The data pattern starts at. O and increments. 
Two file matks are appended and the tape is rewound. 
} a 
program TapeTest.; 
type 
ReqPack = record Ss 
ax, bx.cx,dx,bp,si,di,ds,es,flaqs: integer; 
end; 





const 
rewind: array[O..1] of char ~ ’t-’; 
device: array[O..3] of char = ’mtO’O; 
var 
reqs: regpac.k; 
i. handle: integer ; 
buffer: array[O..2047] of byte; 


beqirn 
for i :- O te 27047 da 
bufferf{ailj s+ i; 
reqs.ax :> $3d02; {qet. oper the tape device} 
regs.ds := seq(device); : 
regs.dx :: ofs(device); 
msdos (reqs) ; 
handle :: reqs..ax; 
writeln(’tape driver handle for MTO is: 


% 


, handle): 
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reqs.ax :: $4400: {aet. device information - IoOctTL} 
reqgs.bx :- handle: 
msdos (reqs) ; 
reqs.dx :- (reqs.dx and sff) or $svo: {set binary mode} 
“eEeQ@s.ax :7 F44O1: 
“x 2:2 handle; 
regs) ; 
writeln(*now writing 10 blocks of 2048 bytes each’): 
for i :- 1 ta IN de {write 10 blocks of 2045 bytest 
beqin 
reqs.ax :: g4qano; {write command) 
regs.tx <= handle: {device handle (fer “mto’)} 
reqs.cx :: 2N4h: {block size} 
regs.ds :: seq(buffer);: {buffer location} 


reqs.dx :> ofs(buffer); 
msdos (reqs) ; 
end: 


writeln(’now writing two file marks and rewinding’); 


“regs.ax :- $4403: {output control string} 

reqs.bx := handle: {tape drive handle} 

regs .cx := 2; fcontrol string size} 

regs.dx := of«(rewingd) - fc lose and rewind control string} 


regs.ds := seg(rewind) ; 
msdos (regs) ; 





regs.ax :: $3enNn:; fclose the tape device} 
‘eas bx := handle; 
regs); 


1.3 Microsoft Qbasic 
1.3.1 YJAPEIO.BAS 


‘em create an 2048 long string of mulls 
ufs = string$(2042,0) 


:-all mtopen 

‘em writ:: 500 byte blacks as indicated: 

em 00 O1 02 03 04 OS Qe O7 OF OF Da Gb Oc Od Oe Uf 
‘em pa ae ay aes 


‘or 1 = 1 to 500 
mid$(buf$,i, 1) = chrs((i-1) and 255) 
ext i 


or 1 = 1 to SO 
call mtwrite(buf$, SOO) 
ext i 
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call mtclose 





call mtopen 

loop: 
bufS = string$(2048,0) 
sum = O 
317e% = len(buf$) 
call mtread(buf%. size%) 
if (sizez% = 0) goto done 


Print “length - “; sizex 

for 1 = 1 to sizcez% 

sum = sum + asc (mid$(buf$, i, 1)) 
next i 


print “sum of bytes in the block is: "; sum 
goto loop 


done: 
call] mtclose 
4.3.2 QBAS.ASM 


PAGE ,12& 
TITLE MTG TAPE DEVICE DRIVER INTERFACE - GBASTIC 


QRASIC INTERFACE 





CALL MTOPEN 

CALL MTREAD(S£, SIZEZ) 
CALL. MTWRITE(SS$, SIZEZ) a 
CALL. MTCLOSE 


at wt f2¢ $9 we Bt we 


CSE.G SEGMENT PARA PUBLIC *CQDE’ 
PUBLIC MTOPEN , MTCLOSE ,MTREAD ,MTWRITE 
ASSUME C5: CSEG 


DSEG SEGMENT WORD PUBLIC "*DATASG’ 

DGROUP GROUP DSEG 
ASSUME. DS - DGROUF 

HANDLE DW @) 

TAPE DB "MTC ,O 

CL. RE.W DB a 

DSEG ENDS 


HANDLE FOR THE TAPE DEVICE 
NAME OF THE TAPE DEVICE 
CLOSE TAPE AND REWIND 


ot @6 a8 


; INITIAL ROUTINE TO OPEN TAPE DRIVE, CALL THIS BEFORE READING OR WRI 
; THIS ROUTINE HAS O ARGUMENTS 


MTOPEN PROC FAR 
MOV AX, SDN2H ; OPEN TAPE HANDLE 
MOV DX, OFFSET DGROUP : TAPE ; ASCII NAME ADDRESS 
INT 31H 
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Jc ERROR >; MSDS ERROR 
MOV HANDLE ,AX 





NOW WE. SET THE TAPE DEVICE FOR BINARY OPERATLONS 
MOV ~ BX,AX ; HANDLE TO BX 
MOV AX,4400H GET DEVICE STATUS 


ae 


21H 

DH,O ; SET DEVICE STATUS (CLEAR TOP) 
u DI, 20H ; SET DEVICE TO BENARY 
MOV AX,440)H > SET DEVICE INFORMATION 
MOV BX,HANDIL E 
INT 21H 


RET 
MTOPEN ENDP 


; ROUTINE TO CLOSE AND REWIND THE TAPE DRIVE. WHEN WRITING, THE DRIVE 
3 WILI FIRST APPEND 2 FILE MARKS, INDICATING LOGICAL END OF MEDIUM 
> THIS ROUTINE: HAS © ARGUMENTS 
MTCLOSE PROC FAR 
MOV AX,4403H 3; CLOSE THE TAPE DRIVE 
MOV DX,OFFSET DGROUP:CL REW ; ADDRESS OF ASCTI STRING °T-’ 
MOV CX,2 
MOV BX,HANDLE 


INT 23H 
MOV AX,3E00H ; CLOSE THE TAPE TN nos 
MOV BX,HANDLE 

INT 21H 

RET 





mMTCLOSE = ENDP 


‘TINE IS CALLED WITH 2 ARGUMENTS, THE BASE ADDRESS Of THE DATA BUFFE 
MAXIMUM BYTE COUNT (SIZE OF THE BUFFER) FOR READS. 
J cwUNT MUST BE LARGER THAN THE LARGEST BLOCK ON TAPE OR 
THE DRIVER WILL REPORT SOLID ERRORS AND NOT READ PAST IT. 


oa ot as 


MHeblll WARNING fiitires 
MAKE SURE THE STRING IS AS BIG OR BIGGER THAN THE LENGTH ARGUMENT 
OR THE SYSTEM WILL CRASH 
TREAD PROC FAR 
PUSH BP 
MOV BP, SP 
MOV BX,a[BP] 


ah *t oe 


OFFSET GF FIRST ARGUMENT (STRING DESC) 


MOV DxX,2(Bx]} : GE1 STRING ADDRESS 
MOV BX, ,é/ BP] 3; OFFSET Of ND ARG CINT LENGTH) 
Mov cx, (Bx) ; GET LENGTH 


PUSH BX 


MOV AX, 3SFG0QH READ FROM TAPE 


MOV. BX,HANDLE ; TAPE DEVICE HANDLE 
INT 21H 

JC ERROR 

POP BX 


Mov [BX], AX SET LENGTH TO BLOCK SIZE READ 
MOV SP.,BP 


POP BP 


@e 
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RET i¢,' 
MTREAD FND? 





> THIS ROUTING 15 CALLED WITH 2 ARGUMENTS, THE BASE ADDRESS of THE Di 
> AND THE BYTE COUNT (S176 OF THE BUFFER). 
MTWRITE 9 PROUT AR 

PUSH BP 

MOV BP SSP 


MOV BX,EERR] - OFFSET Of TIRST ARGUMENT (STRING DESE) 
MOV DX,21Bx] >: GET STRING ADDRESS 

MOV BX ,e( BF] - OFFSET UF @ND ARG CINT LENGTH) 

Mov Ox, [Rx] > GET LENGTH 

MOY AX, 4000H - READ FROM TAPE 

Mav BX HAND E. - TARE DEVIGE HANDLE 

IN] eH 


JG: CRROR 

MOV SP OBE 

Por BP 

RET 2ee 
MTWRITE CNDP 


ERROR PROM: 
>; HANDLE | RROARS HERE, 
Ime 6 

ERROR CNDEF 


CSEG ENDS 
LIND 
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om 1 Read Me First 
1.1 Inventory Checklist 


Before you get started, check that your TC-PC 
package includes the following: 


o TC-PC circuit board and bracket. 

o Two ribbon cables, each 19 feet long. 
o One 5 1/4" floppy disk. | 

Oo Documentation. 


NOTE 


Be sure to fill out your warranty card 
(located at the front of this manual) and mail 
it in. 





1.2 Related Reading 


This manual assumes some familiarity with the 
PC-DOS operating system and the IBM PC/XT/AT 


hardware. All references to operating system 
commands and I/O port designations in this 
manual assume operation under a single-user, 


single tasking version of the PC-DOS operating 
system. 


You can find additional information in the 
following IBM publications: 
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o Guide to Operations 


o Disk Operating System 


o Technical Reference Manual 


1.3 Factory Configuration 


The TC-PC is shipped from the factory in this 
configuration: 


o Address switches set the I/O base 
address to 36c hex. 


o Jumpers select DMA channel I. 





1.4 Standard Features 
The standard TC-PC features are: 

o Switch selectable I/O address (4 
contiguous ports required for 
operation). 

o Jumper selectable DMA channel. 

Oo Record lengths from 1 to 65,535 bytes. 

o Supports up to eight tape transports. 


o Modes: PE and NRZI at 8808, 169060, 3200, 
and 6258 bytes per inch. 


o Compatible with most industry standard 
formatted tape drives. 
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o Maximum data transfer rate 192,808 KBS 


1.5 System Requirements 

The TC-PC will work with all PC-1, PC-2, 
PC/XT,PC/AT and 188% compatible machines, such 
as the COMPAQ portable, and the ZENITH PC-1I50. 


Operation with the supplied software requires 
a minimum of 328K bytes of RAM memory. 


One DMA channel is required for operation. 


nn 
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2 Installation 





2.1 Remove the System Cover 


Set the power switch on your computer to the 
off position. Set the power switches on all 
attached devices to the off position. Un-plug 
the computer and all attached devices from 


electrical outlets. Disconnect all cables from 
the rear of the computer. 


Move your keyboard and all external options 
away from the work area. 


Place the personal computer in a position so 
you can work at the rear. 


Use a flat blade screwdriver to remove all 
cover mounting screws. Turn the screws 
counterclockwise to remove. Be sure to save all 
Screws for the replacement of the cover. 





Move to the front of your computer. 
Carefully slide the cover to the front. When the 
cover will go no further, tilt it up, remove it 
from the base, and set it aside. 
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2.2 Select an Open Card Slot 


Look at the inside left rear of your 
computer. You see five slots in the Personal 
computer and eight slots in the Personal 
Computer XT. Install the adapter in any but the 
short slots in the XT. If you have a PC/AT you 
May use either the 8 bit or !6 bit card slots. 


Use a flat blade screwdriver to remove the 
screw that holds the expansion slot cover in 
place. Turn counterclockwise to loosen the 
screw. Be sure you save the screw to install the 
product later. 


ep f—Save 









Rear Panel 


Vy 
Seay hh, 


WH 
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2.3 Install the Ribbon Cables 


Locate the socket end of both cables which 
mate with the header connectors on the TC-PC, 
board. Pass both of these cable ends through 
the back of the computer, from the outside to 
the inside. Note that the colored stripe must 
be positioned "up" as the cables enter the 
computer. Now thread the cables through the 
bracket on the TC-PC. The sockets may now be 
attached to the connectors on the TC-PC as 
shown. 
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2.4 Install your TC-PC 


With the cables now attached, hold the top of 
the TC-PC and press it pe | into the expansion 
slot as shown below. align the slot in the TC-PC 
retaining bracket with the hole in the rear 
panel of your computer. Start the screw 
Clockwise, then tighten with a flat-blade 
screwdriver. 

Your TC-PC is now installed. 


Ly 
6 
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Not Properly 
Aligned Aligned 
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2.5 Reinstall the System Cover 





Replace the cover by putting it in a position 
as shown. Carefully slide it toward the rear of 
the computer. 


When the cover is all the way to the rear, 
align the cover screws with the threaded tabs. 
Use a flat-blade screwdriver and turn the screws 
Clockwise to tighten them. 
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2.6 Connect Cables to Tape Drive 


2.6.1 Locate Drive Connectors 


Examine the rear of the tape transport and 
locate two card edge connectors that match the 


connectors on the ends of the TC-PC cables. 


2.6.2 Identify Drive PI & P2 


These drive connectors are labeled, normally 
Pl and P2. On some transports these connectors 
are labeled differently. On these transports, 
the lower numbered connector generally 
corresponds to PI and the higher numbered 
connector corresponds to P2. It should be noted 
that on transports that have two sets of PI & P2 


connectors, either set may be used. 


2.6.3 Identify pin one end 


Each connectors has pins, numbered | - 58. 
On some transports the chassis clearly 
identifies the pin one end of the connector, but 


on others you must carefully examine, the 
connector itself. Close inspection will reveal 


either a number silkscreened on the board or a 
number formed in copper. Finding a 1! or a 2 
indicates the pin one end of the connector. 


2.6.4 Identify and connect cables 
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Press the longer of the two TC-PC cables onto 


the Pl connector, with the colored stripe 
Oriented toward the pin one end of the 
connector. Attach the shorter cable to P2 ina 


Similar manner. 
Your system is now ready to test. 





2.7 Test the Complete System 


2.7.1 Back up distribution disk 


ply power. ee your personal computer and 
age Pea -Syst 


Refore testing your tape sub-system, follow 
the procedures outlined in the DOS manual for 
copying a disk. Use either the DISKCOPY command 
Or the COPY command. 





2.7.2 Load Tape 


Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 
the tape transport. Note: this procedure will 
write onto the tape, so make sure the tape you 
choose has nothing important written on it, 
When the tape is loaded, place the transport 
online. 


2.7.3 Execute BTEST 
Execute the program BTEST. The transport will 


make a few short passes on the tape, and should 
conclude with the message 
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All tests successful. 


With this result, you are now ready to _ 
proceed with any of the applications in section 
3, Software. 


For any other outcome of BTEST, please refer 
to BTEST, section 3.1.3 . 


3 Software 
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3.) BTEST 





3.1.1 Purpose 


BTEST provides a rapid test of the integrated 
tape sub-system. 


3.1.2 Features 


BTEST tests all tape functions utilized by 
Overland Data utility software. These include: 


Oo Write Data 
Oo Write File Mark 


oO Erase Fixed Length 





o Read Data (with verify) 
Oo Read File Mark 

Oo Space Forward Block 

Oo Rewind 


And on dual speed transports: 
Tests high and low speed operation. 


Diagnostic error messages. 


Seles Use 


Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 
the tape transport. ote: j cedu j 
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write onto the tape, so make sure the tape you 
choose othi importa on j 

When the tape is loaded, place the transport 
online. 


Execute the program BTEST. The transport wil: 
make a few short passes on the tape, and shoulda 
conclude with the message 


All tests successful. 


With this result, you are now ready to 
proceed with any of the applications in section 
3, Software. 


Failure to complete successfully may indicate 
a cable connection problem, an unusual status 
being returned from the transport, a failure of 
the transport to return data exactly as it was 
written to tape, or other, perhaps more exotic 
problems. 


The following will describe exactly what 
BTEST does during testing, to provide some 
insight into the cause of any problems 
encountered running BTEST. This information, 
when combined with transport status data, shoul 
enable you to isolate any transport interface 
problems. 


After signing on, BTEST tests for transport 
status that would indicate that the the cables 


May be connected in error. 


After placing the transport online and 
pressing the return key, online status is 
checked. If status checks ok, a rewind command 
is issued to the transport. BTEST then waits 
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(perhaps forever) for a status to 
terminate. If a transport problem exists that 


causes rewinding status to remain true, never 
going false, then BTEST will remain stuck at 
this point until the machine is re-booted. 


BTEST next tests for the presence of on-line, 
beginning of tape, and ready statuses. If 
present, 2@ erase fixed length commands are 
executed. On dual speed transports, this occurs 
at high speed (198 ips typically). The 
transport is then rewound. 


Ten blocks of data, each 598 bytes long are 
then written to tape. Each block of data 
contains an incrementing count data pattern as 
illustrated in section 3.7.2 of WRITE.C. Hard 
error and corrected error status is checked 
during all writes, and will be flagged to the 
user if they occur. 





A file mark is then written to tape, followed 
by ten more data blocks as above. Two file 
marks are written and the tape is rewound. 


On dual speed transports the speed is now 
reduced to 25 ips on most models. 


Nine of the first ten data blocks are read. 
The size of each data block is compared with 
what was written, and an error mesSsage is 
produced if the sizes do not compare. 


When the tenth data block is read, the 
returned status should include Data Busy 


Transition, On-line, and Ready. An error message 
will be displayed if these are not present. 
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The data read is then compared byte for byte 
with what was written. Any discrepancies are 


reported as data compare errors. 


One more read is performed, which should 
detect the file mark created during the write 
pass. If File Mark status is not present after 
this read operation, an error message is 
generated. 


Space Forward Block commands are now issued 
until File Mark status is once again 
encountered. This concludes the functional chec!} 
of the coupler/transport interface. With the 
successful execution of the above tests, the 
message "All tests successful." is displayed. 


3.1.4 Limitations 


BTEST is not a complete diagnostic testing 
system, but it does provide a sound evaluation 
of your nine track tape subsystem functions. 
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322 FDUMP 





3.2.1 Purpose 


The purpose of FDUMP is to provide a tool to 
examine the data and format of a tape. FDUMP is 
useful for programming and troubleshooting. 


3.2.2 Features 


The FDUMP program provides the following 
features: 


o a hex and ascii or EBCIDC dump of data 
from tape to screen 


o selective positioning on the tape by 
filemarks 





o continuous count of filemarks from BOT 


© continuous count of data blocks from 
the last filemark 


© continuous tape drive status display 


3.2.3 Use 


Find a tape, remove the write enable ring in 
the back of the tape reel (for added security), 
and load it onto the tape transport. FDUMP does 
not write to tape, it will only read data from 
the tape. 


Load DOS into your PC, select the correct 
drive and type: 
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If your tape is in EBCIDC you may translate 
to ascii by using a command line switch such as: 


X>fdump / <CR> 


The following messages should appear: 


FDUMP 
(c) OVERLAND DATA INC. ,1983,1984 
Tape Hex and Ascii dump for the TC-PC Ver 2.,r 
Assumes that this data is in EBCIDC 
allows up to nnnnn byte block reads 


Ors 
X>fdump <CR> 


The "nnnnn" will vary depending where FDUMP 
loads in memory. 


Enter tape drive address (8-7): 


This lets you select the transport address. 
Carriage return defaults to transport address Q. 


Enter desired file position (FMK from 
BOT @<—n): 


This function is used to position you on the 
tape. The default value is @. 


To reposition while on the tape strike any 
lettered key, and the following will appear: 
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Enter desired file position (FMK from 
BOT @-n): 


The transport will then position either 
forward or backward as necessary to locate the 
requested File Mark. 

IMPORANT KEY STROKES 

o “S start/stop data scrolling 
o “C exit to DOS 


Oo Space Bar: allows you to skip to the 
next data block 





The first line of each block of data contains 
transport status information as well as tape 


position data. 


The transport status is compressed into four 
hexadecimal (base 16) characters at the 
beginning of the status line. The following 
table shows the status map. 


STATUS BIT MAP 


BIT 15 BIT 14 BIT 13 BIT 12 


PAR IDL NRZI DBYL 
BIT I! BIT 16 BIT 9 BIT 8 
RWD FMK CER HER 


BIT 7 BIT 6 BIT 5 BIT 4 
EOT BOT SPD ONL 
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BIT 3 BIT 2 BIT | BIT @ 
FPT RDY DBSY FBSY 


As an example, a status of 


1615 


maps to Data Busy Latch (a coupler status 
normal at the end of read operations), On-line, 
Ready and Formatter Busy (indicating that the 
transport was concluding it's movement when the 
read operation was complete). 


3.2.4 Limitations 





The FDUMP program has the following 
limitations: 


Maximum data block size is dependant on where 
FDUMP loads in memory. Typical upper limits 
vary from 25 to 35K. 
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363 TAU 
3.3.1 Purpose 

The TAU (Tape Archive Utility) program is 
designed to create an organized and efficient 


way to back up and restore individual files or 
groups of files to 9-track tape. 


3.3.2 Features 


The TAU program allows you to have the 
following at your disposal: 


o individual file backup 





oOo individual file restore 
o use of MS-DOS wildcards such as "*,*" 


o disk drive selection for I/O 


O change pathname selections from within 


o data encryption for security 
3.3.3 Use 


Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 


the tape transport. : Ss ocedure wi 
write onto the tape, so make sure the tape you 
choose othi j i 


When the tape is loaded, place the transport 
online. 
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How to use TAU 
Load DOS into your PC then select the correct 


drive and type 
<x>: tau <CR> 


The program is now loading, wait just a 
moment and you should see the main menu. In 
order to use tau you must initialize your tape. 
To do this select "I" from the menu . 


initialize the tape ? 


Type yes <CR> to initialize your tape, typin« 
no <CR> returns you to the main menu. 


Data storage mode: 
: 2k records with error correction 
records. 





2: compress records into 8k tape 
blocks. 


Option | writes data out to tape in a series 
of 2k data blocks. Four of these are normal datz: 
blocks. The fifth data block is a parity data 


block. 


Option 2 write data out to tape in 8k data 
blocks. 


Select option 2 <CR>. 


How many tape volumes on this 
tape (1-128) ? 
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We recommend creating as many volumes on the 
tape as you have directories on your hard disk. 


Enter tape name: 


Give it a name indicative of it's contents. 
The tape is now initialized, and you should be 
back at the main menu. 


Next we need to select a volume. NOTE: You 
must be in a volume to move files to or from the 


tape. 


Enter the desired tape volume (no 
higher than the number of volumes you 


selected when you initialized the 
tape.) 


Select a volume number and strike return. 
The current volume number will now be displayed 
on the main menu. 


o To write to tape use the A(ppend) 
function. 


o to read from tape use the R(etrieve) 
function. 


© to display the tape file directory of 
the selected volume use the D(isplay). 


These and all other functions are covered in 
the menu overview. 


fe) THE MENU OVERVIEW 
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A(ppend) 
o New volume , enter volume name? 


Once again be sure to use a meaningful name. 
o Enter file to backup, (<CR> to exit): 


Type ile to be backed u wild cards 
such’ 4s kpe, h3s Fe Com" can be ised by the TAU 


program. After selecting the files for back up 
hit one extra <CR> to signify the end of the 
file list. The selected files will now be 
written to tape. 


D(isplay file directory of the selected 
volume) 


This will display the files in a selected 
volume. Strike <CR> to exit. 





T (display tape directory of volumes) 


This will give you a listing of the tape 
by volume name, number and creation date. Strike 
<CR> to exit. . 


R(etrieve files from a selected volume) 
o Files to retrieve ?(<CR> to exit) 


Type the filename to be retrieved, wildcards 
such as "*,*" or "*.com" can be used by the TAU 
program. After selecting the files for retrieva. 
hit one extra <CR> to exit and retrieve the 
files. 
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E(nable/disable encryption) 


o Enter key: 


Use a code word that you can remember. Case 
is important, as are embeded spaces. 


S(elect a disk for I/O) 
o Enter desired disk for I/O? 


Type the drive letter that you wish to read 
files from or write files to. 


C(lear files from the selected tape volume) 





IMPORTANT 
This will wipe out al 
ve t 


Q(exit to system) 
This will exit the program and return you 


to DOS. 
W(rewind and unload the tape drive) 


This will, as it says, rewind and unload 
the tape drive. 


I(nitailize) 


Oo initialize the tape ? 
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Type yes to initialize your tape, typing no 
returns you to. the main menu. 


Oo Data storage mode: 
Il: 2k records with error correction 


records. 


2: compress records into 8k tape 
blocks. 


Option 1 writes data out to tape in a series 
of 2k data blocks. Four of these our normal daté: 
blocks. The fifth data block is a parity data 
block by witch data can be recreated if data 


loss occurs. 


Option 2 write data out to tape in 8k data 
blocks. 


o How many tape volumes on this 
tape (1-128) ? 


We recommend creating as many volumes on the 
tape as you have directories on your hard disk. 


o Enter tape name: 


Be sure to give it a mane that will mean 
something to you and the other or future users 
of this tape. 

The tape is now initialized, and you should 
be back at the main menu. 


V(select a volume) 
o Enter the desired tape volume(this is 


the number of volumes you selected 
when you initialized the tape.) 
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Select a volume number and strike return. 
Now look at the top left hand corner of your 
screen and there it should tell you what volume 
you are in. 


3.3.4 Limitations 


The TAU program does have the following 
limitations: 


O a maximum of 25@ files per volume 


o a file must be no more than 8Mb long 
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3.4 BAKUP 
3.4.1 Purpose 


The BAKUP utility is for mirror image back ur 
and restoration. It will copy data byte for byte 
to tape. The restoration process will over-write. 
what ever is on the disk. For individual file 


back up use the TAU utility. 


3.4.2 Features 


The BAKUP utility allow you to have the 
following at your disposal: 


o mass back up to tape 
Oo mass restore to disk 


Oo optional status displayed during back 
up and restoration 


3.4.3 Use 


Find a blank tape, insert a write enable rinc 
in the back of the tape reel, and load it onto 
the tape transport. : l Cc e_ will 
Write onto the tape, so make sure the tape you 


choose has nothing important written on it. 
When the tape is loaded, place the transport 


online. 


BAKUP is a command line driven program. The 
following are the command line features: 


Oo -s this is the save command 
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o -r this is the restore command 


o -v (verbose) this allows you to have 


the drive and tape characteristics 
displayed 


NOTE: r and s are mutually exclusive 
Load DOS into your PC then select the correct 
drive and type 


<x>: bakup -rv ds: <CR> 


Note that you must include the drive letter 


in the command line, even if you are backing up 
the default drive. 





The program is now executing. When it is 
finished it will exit to DOS. 


3.4.4 Limitations 
BAKUP will not save data from a disk that is 
larger than the capacity of the mounted tape. 


Avoid restoring to disks other than that from 
which you saved. 


Mirror image backup/restore programs, such as 
BAKUP, copy ever yeuEnd in the DOS partition of 
the specified disk. This includes the file 
allocation table, which contains bad spot 


information. Bad_ spots, when they occur on a. 
disk, are randomly located. If this information 
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is restored to a different disk, the operating 
system will assume there are errors where 
probably none exist. Worse than that, the syster: 
may consider some areas of the disk to be good 
which should in fact be mapped as being bad. 


The only reliable way to use BAKUP to 
transfer information from one disk to another is 


to haves 
I Disks formatted to identical size. 
2 No bad spots on either disk. 
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3.5 CONFIG 


3.5.1 Purpose 


The CONFIG program must be used when the DMA 
channel has been changed. CONIFG also allows you 
to change the TC-PC I/O address. Remember, you 
must also move the jumpers to change the DMA 
channel, or change the dip switch settings on 
the board. 


3.5.2 Features 


The CONFIG utility allows you to: 


o change the configuration of the DMA 
channel for the TC-PC controller 
board | 





o change the configuration of the I/O 
board address 


3.5.3 Use 


‘The CONFIG program does not require the tape 
drive to be connected or online. 


Tf you are changing the board I/O address, 
reset the dip switch on the board before you run 
the CONFIG program. If you are changing the DMA 


channel, move the shunt jumpers to the correct 
position. 


BOARD ADDRESSING 
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The TC-PC controller occupies four 
consecutive I/O locations. An 8 position switc}. 
allows the board to be addressed on any four 
byte boundary within the 1924 byte address rangc 
of the IBM PC. Switches set to the on position 
represent a logic 9, set to off, a logic 1. The: 
following illustration shows the board addressec. 
as shipped. 


Address A9 AS AT AG AS AS AZ A2 
Switch 8 7 6 5 4 3. 2 


set to OFF OFF ON OFF OFF ON OFF OFF 
Binary I I Q 1 I p l | 
Hexadecimal 36C 

DMA CHANNEL 


The board operates uSing DMA channel | as 
shipped. To enable operation using other 
channels, jumper as follows. 


Channel no. Pin pairs to shunt 


I —=+U,V 
2 YJ 
3 W,X 


>> CAUTION !! << Channel 2 operation is 
not advised as this channel is used by the IBM 
floppy disk controller. 


To invoke the 'config' program, type 
x:> [n:]config <CR> 
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from the command prompt. 

The following should appear on the screen: 
UTILITY CONFIGURATION PROGRAM vers 1.x 

(c) 1985 OVERLAND DATA INC. 


Enter filename<cr> to configure or <cr> to 
quit. 


When entering a filename, type the complete 
filename, such as "“depot.exe", not just "depot". 
After entering a filename, you will see this: 


Configure Tape Controller 


Enter new value<cr> to set new value, or <cr> 
to quit. 





filename -> 


SC4LCNLNG <6 6 060046 0 6-0-6066 506 60 ¥ 8 60 


This is where you can change the DMA channel 
for the software. Also remember to change the 


shunt jumpers on the board. Next you may change 
the bodra tf O address. ¥ y 9 


Enter the new board I/O address, if it is 
being changed. Remember to change your switch 
settings. Don't forget that this address is 
entered as a hexadecimal (base 16) number! 
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Item to change: Current Value: 


DMA Channel (9-3): = | (basel®) 
New Value: 


ODI Controller address: = §36c(basel6): 
New Values: 


If you have not changed any of the 
values, CONFIG will remind you by saying: 


No change wqas mode to the 


configuration. Do you wish to change 
any of these values ?(y,n) 


If a change had been made to the 
selected program, CONFIG would continue as 
follows: 


Configuration changed to: 
Item: Value: 


DMA Channel (9-3) = | 
ODI Board Address = §36C 
Do you wish to change any of these values 
2?(y,n) 
At this point you can continue making 
changes, or exit and run your re-configuered 
software. After answering y(es) or n(o) to the 


previous question, config will respond with: 


Do you wish to configure another file ?(y,n) 
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Answering y(es) will repeat the 
configure process, allowing you to select a new 


file to configure. A n(o) reply will return you 
to DOS. 


3.5.4 Limitations 


The CONFIG program will only configure 
software written for the TC-PC controller card 


from OVERLAND DATA INC. 








34 











Copyright 1984, Overland Data Inc. 


3.6 RTI 
3.6.1 Purpose 
The RT1 subroutine is for those users that 


wish to do more specialized functions and need 
to write custom software. 
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3.6.2 Use 


The subroutine RT] may be called from a user 
program in the same manner as any other 
subroutine. The general form of the call from 
ne’ 1S 


rtl(argl, arg2); 


retinfo=rtl(argl, arg2); 


In the first instance, no return value is 
needed. This format is usual whenever the drive 
status is known or the command does not require 
known drive status. The second format is a 
function call and the returned value may be 
either the tape status or other information such 
as data block length after a read command. In 
no case are the arguments argl or arg2 altered. 





All rt! commands are distinguished by the 
required argl. This argument ranges in value 
from @ thru 255 and specifies the command to be 
executed, ie: @ is a read block command while 


253 is a rewind to beginning of tape command. 
The second argument, arg2, is utilized only 
where the specific command requires additional 


information. 


See section 3.7 for an example program 
illustrating the use of rtl from a high level 
language. 


TC-PC RTI] FUNCTIONS 





The following function table describes each 
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RT1] operation and code number. 
FUNCT CODE ARGS DESCRIPTION 


SET25 255 1 Set tape operation 
speed at 25 inches per 
second. Status 
returned. 


SET1@9 254 I Set tape operation 
speed at 1998 inches per 
second. Status 
returned. 


REWIND 253 l Rewind the tape to the 
beginning of tape 
marker. This operation 
takes about 2 and 1/2 
minutes if at the end 
of a long (2408 feet) 
tape. The calling 
program is returned to 
as soon as the rewind 
command is issued. 
Status is returned. 


SETPORT 25] 2 Set the TC-PC base port 
address to the value of 
ARG2. The default port 
value is 36ch. This 
command should be used 
prior to any other tape 
command. Status is 
returned. 


i. SETSIZE 259 2 ARG2 sets the buffer 
size for write commands 
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and the maximum buffer 
Size for read commands. 


Status is returned. 


TRYS 249 2 ARG2 sets the maximum 
number of tries allowed 
to correct write and 
read errors. The 
default value of 16 
should be sufficient 
for all but diagnostic 
purposes. Setting a 
value of 1 will disable 
error correction 
processes. Status is 
returned. 


UNLOAD 248 ! Rewind and unload the 
selected tape drive. A 
tape will have to be. 
reloaded before other 
tape operations can be 
performed. Some tape 
drives (not streamers) 
will simply go offline 
but in any event manual 
intervention will be 
required to continue 
tape operations.Status 
is returned. 





SETADR 246 2 ARG2 selects the tape 
drive address (8-7).Up 
to 8 tape drives may be 
daisy chained on one 
TC-PC controller. Tape 
drive selection should 
be performed only when 
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the currently selected 
drive status IFBY 
(formatter busy) is 
false. Status is 
returned. 


STATUS 245 ] Return the status word 
for the selected drive. 
This command may be 
issued at any time. 


RSIZE 243 1 Return the size of the 
last read block. This 
will be the byte count 
of the last read block 
unless the block was 
larger than the buffer 
limit established by 
SETSIZE in which case 
it will be that limit 
with the TLNG bit in 
the status word set. 





READ Qg 2 ARG2 sets the base of 
the read block 
transfer. In a 'C! 
subroutine call ARG2 
would be an array name. 
After the program 
returns the array would 
contain the contents of 
the tape block. Status 
is returned. 


WRITE 2 2 ARG2 sets the base of 
the write block 
transfer. In 'C' ARG2 
would be an array name. 
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22 


16 


The contents of the 
array (up through 
SETSIZE) are written to 
tape. Status is 
returned. 


Write a file mark to 
tape. This is a 
special, non data, 
identifier frequently 
used to separate data 
groups and identify a 
logical end of tape. 
Status is returned. 


Erase a fixed length of 
tape (about 4 inches). 
Status is returned. 


Erase a length of tape 
representative of the 
write block size set by 
SETSIZE. Status is 
returned. | 


Search forward-block. 
Data is not transferred 
and error detection is 
not performed. File 
mark status is tested 
and counts as a block. 
Status is returned. 


Search reverse block. 
As in SFB except tape 
motion is reverse. 
Status is returned. 
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SFF 20. | Search forward file. 
As in SFB except 
operation continues 
until a file mark is 
detected. Status is 
returned. 


SRF 21 l Search reverse file. 
As in SFF except motion 
is reverse. Status is 
returned. 


TC-PC RTI STATUS 


The status word returned is an integer where 
each bit represents a drive or interface status. 
Some transient status bits are latched to... 
provide information about the previous tape 
command. These latched signals include 
corrected error (ICER), hard error (IHER), and 
file mark detected (IFMK). Other bits indicate 
the readiness of the drive to accept interface 
commands, write protection, etc. A detailed 
description of these status bits may be found in 
the Microstreamer or other compatible tape drive 
manual which should be thoroughly read and 
understood before extensive tape system 
programming is undertaken. 


STATUS COMMAND 
BIT 
g IFBY; formatter busy, the tape drive 


formatter is busy executing or completing a 
command. While true the drive address 
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select should not change. With GOTAPE it 
is generally_not necessary to monitor this 
liné in single tape drive systems.'. 


IDBY; data busy, the tape drive formatter 
is in the execution phase of a tape command 
and the DMA may be active. This status 
should not occur uSing GOTAPE as the 
Subroutine loops on a tape command until 
terminated by IDBY going false. 


IRDY; tape ready, true except when 
rewinding, offline, or not selected. 


IFPT; tape file (write) protected, the tape 
drive will not accept a write or erase 
command when this status is true. Tape 

write protection may be achieved by removal“ 
of the plastic ring on the back side of the 
tape reel. 





IONL; online, the selected tape drive is 
online. The drive may be manually placed 
online or offline from it's front panel. 


ISPD; last tape motion command at high 
speed, true if the previous tape motion 
command was at high speed. This 

Status is of diagnostic. use only. 


IBOT; at beginning of tape, the tape is 
positioned at its physical start as 
indicated by a reflective marker. Only 
forward operations are permitted when this 


Status is true. 
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IEOT; at end of tape, this status indicates 
that the tape position is at or past the 
end of tape reflective marker. This status 
does not mean that no more read or write 
Operations can take place. Indeed, tape 
operations are allowed for 5 to 19 feet 
more providing room for an orderly flagging 
and termination of the tape file. In 
general, two consecutive file marks flag 
the logical end of tape (which usually 
occurs well before the physical marker). 


IHER; hard tape error, should this status 
occur when writing where TRYS has been set 
at 16 or more or left at the default value, 
either the tape path is badly in need of 
cleaning or the drive or interface (less 
likely) is faulty. When this error occurs 
in the read mode, it generally represents 
serious media deterioration or physical 
tape damage. A more common cause is when a 
read operation is made past the last block 
written on the tape causing partial blocks 
from previous recordings to be encountered 
aS unrecoverable errors. 


ICER: corrected media error, this status 
(in the absence of IHER) indicates that a 
media flaw caused Signal level 
deterioration in one of the nine recorded 
channels but that the error correction 
process was successful. 


IFMK; file mark detected, status occurs 
when the prior tape command positioned tape 
through a file mark record. Phase encoded 
file mark records do not contain data or 
cause data strobes. 
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IRWD; drive rewinding, the selected, online 
drive is rewinding to beginning of tape. 
Any tape motion command issued through 
GOTAPE will be delayed until the rewinding 
is complete. 


DBYT; data busy (status bit 1) transition 
false, occurs after an IGO (tape motion 
other than rewind or unload, see 
Microstreamer manual). DBYT is mainly of 
diagnostic value. 


TLNG; read block length is longer than 
maximum buffer size as set by the SETSIZE 
function of the GOTAPE call. If this bit 
is set the RSIZE function will return only 
the value previously set by SETSIZE. 
Clocked data bytes after this limit were 
not transferred into memory. 


OVF; this non-hardware related status bit 
indicates that a data transfer was 
attempted that would have crossed a 64k 
page boundary in memory. The DMA structure 
of the PC will produce disastrous results 
if a page boundary is crossed. When this 
status is encountered, the user should re- 
try the transfer at a different address. 


EOTL; some 9 track machines do not latch 
End Of Tape status. This status is 
monitored in rtl and stored, and is 
returned from the time that EOT is 
encountered until the next rewind command 
is received. The status is not too bright, 
however, and will remain set even if a 
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reverse motion command, ie space file 
reverse, etc. causes the EOT marker to be 


passed in the reverse direction. 


3.6.3 Limitations 


If you intend to use rtl, read all of the 
following at least twice! 


RT! is currently organized for operation with 
"C" compilers. "C" compilers for the 8988 
traditionally pass their variables on the stack 
and return them in the AX register. This means 
that the beginning of the rtl subroutine first 
retrieves it's parameters from the stack and 
puts them in local storage. On return rt] 
places it's return variable in the AX register. 
Additionally, rt! assumes the DS register is 
being used for reference to the data area. If 
you are using another segment for offset 
reference, you must modify the "setdma:" section 
accordingly. 


A major limitation of all DMA operations in 
the PC environment is the inability to transfer 
data across 64K hardware boundarys. The TC-PC 
falls prey to this restriction as well. Care 
must be exercised not to attempt to write data 
across one of these boundarys, as you will 
probably write over either a portion of your 
program, or the operating system. This will 
cause totally unpredictable, pathological 
behavior in your system. Overland Data software 
performs buffer allocation by locating the 64K 
hardware boundary, if it exists, in our 
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allocated data space and measuring the amount of / 
memory available on either side of the boundary 


and uSing the largest chunk. 





To use rt] with other compilers you must 
first familiarize yourself with the section of 
your compiler manual that discusses assembly | 
language subroutines. This will provide 
information on how your compiler passes 
parameters to subroutines, and where it expects 
return parameters to be located. You then have 
two approaches to interfacing rtl: 


I. Create a separate assembly language 
routine that acts as a go-between, getting 
parameters as specified by your compiler and 
pushing them on the stack for rtl. The 
go-between program will then call rtl. On 
return from rt] the go-between will then be 
required to put the return parameter wherever 
the compiler requires it. 





2. Modify the first few lines of rtl1 to 
accommodate your compilers parameter passing 
mechanisms. (Perhaps the easiest approach.) 
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Sat TAPECOPY 
3.7.1 Purpose 


Tapecopy iS a program that allows you to make 
mirror image copies of 9-track !/2 inch tapes. 
This program does require two tape drives. 
Tapecopy is provided in two forms. One is a 
compiled executable file. The other is a source 
code file to demonstrate the use of the RTI or 
gotape subroutine. 


3.7.2 Features 


The Tapecopy program allows the user to make 
duplicate copies of nine track tapes. 


3.7.3 Use 


Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 


the tape transport. Note: this ocedure wi 
write onto the tape, so make sure the tape you 
choose has nothing important written on it, 


When the tape is loaded, place the transport 
online. 


To use TAPECOPY type: 
X>tapecopy <CR> 
It should prompt you with: 


Tapecopy Utility 
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Copyright 1985 Overland Data Inc. 

Version 1.x date 

Maximum data block xxxxx 

Next TAPECOPY will ask you for the source 
address of the destination address of the tape 
drives. Choose a drive address from (@ - 7). 

Source drive address? -> x 

Destination drive address? -> x 


When TAPECOPY is finished it will give you 
one of these two messages: 


Source is at EOT(end of tape) 


Double filemark was detected(which is the 
logical end of tape. 





3.7.4 Limitations 


The TAPECOPY program has the following 
limitations: 


o The destination tape must be the same 
Size or larger than the source tape 


o No provision is made for splitting 
source data to multiple destination 


tapes. 
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3.8 DEPOT 


3.8.1 Purpose 
DEPOT is a "Data Exchange Program with 


Optional Translation" which provides a means to 
transfer data between system disk and magnetic 


tape. The Data can be transferred to or from 
tape in its binary form or optionally be 
converted to the ASCII (American Standard Code 


for Information Interchange) or EBCDIC (Extended 
Binary Coded Decimal Interchange Code) character 
sets. The program assumes, if translation 1s 


specified, that data to be translated to EBCDIC 
is ASCII and data to be translated to ASCII is 
EBCDIC. 


3.8.2 Features 
DEPOT allows the following : 


o data interchange from tape to disk 
© data interchange from disk to tape 


o conversion from ASCII to EBCDIC 
oOo conversion from EBCDIC to ASCII 


© position to arbitrary location prior 
to data read 


3.8.3 Use 
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Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 
the tape transport. : ocedure wi 


Cc 
When the tape is loaded, place the transport 
online. 


HOW TO USE 


Data from disk files can either be appended 
to tapes which already contain data recorded by 
BEPQbeQr it can be recorded at the beginning o 


Eee Sara alate i care con ae Perce ec 
specifyi e file number e data oc 
within’ che bbe! and the amount of data to read. 


To facilitate the handling of data which is 
stored as card images, a provision is made to 
insert a carriage return and line feed at 
selected locations when the file is rewritten to 
disk. 





Translation. 
Any required character translation takes 


place in system memory before the data is 
written to tape. 


STORING DATA ON TAPE. 


Disk data files. 
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The data to be stored on tape must exist 
in a disk file which is in the currently logged 
disk directory. The entire disk file will be 
transferred to tape without interruption and the 
Gisk file is not modified in any way. 

Tape data files. 


Data is stored on the tape as sequential 
files which are made up of data blocks. The data 
in each block is a binary image of the data in 
the specified disk file. Each file is separated 
from the preceding file by one file mark and the 
last file is terminated with double file marks 
to indicate the logical end of tape. No 
directory is maintained of the files on tape and 
no block identification bytes are inserted. 


Block size. 


The size of the data blocks to be written 
must be specified. DEPOT determines the amount 
of unused memory that iS available for storage 
and establishes a temporary data buffer. The 
size of this area will be greater than 19K but 


less than 64K bytes long. The specified block 
size can be any number between 1 and the buffer 


size. 


Although it is common practice to use block 
sizes which match disk sector sizes, this is not 
necessary and can result in poor tape . 
utilization if the disk sectors are small (i.e. 


128 bytes per sector). 


Appending to existing data. 
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When a tape is to be used which already 


contains data recorded by DEPOT, a new, file can 
be appended to the fape.” DEPOT accomplishes this 


by locating the two filemarks which indicate the 
logical end of data, then erasing the last file 
mark and writing the data. The new file is then 
terminated with two filemarks and the tape is 
rewound. 


Writing to new tape. 


When a tape is to be used which does not have 
valid data or has data which is no longer 
needed, the option to write a new tape will 
cause data to be written from the beginning of 
tape. The new data is terminated with two 
filemarks and the tape is rewound. 


If the last sector of the disk file does not 
completely fill the last tape data block, the 
unused portion of the block is filled with 
binary zeros so a full block can be written. 


RECOVERING DATA FROM TAPE. 


Tape data files. 

Data is recovered by locating the specified 
file, the first record to be read within the 
file, then reading the specified data. Because 
there is no directory of the.data on the tape, 
the file is located by counting the number of 
file marks from the beginning of tape and the 
records are located by counting the records from 
the file mark. 
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Block size. 


Data will be read from the tape regardless of 
the size of the recorded block. However, if the 
block size is greater than the data buffer area, 


excess bytes will be lost. 
Disk data files. 


DEPOT will create a new disk file to accept 
the data from the tape. Data is recorded on the 
disk by utilizing the operating system disk file 
Management system. 


OPERATION. 
Loading DEPOT. 


Load DEPOT using the program loading 
procedures for your operating system. DEPOT will 
load and size the memory space that is available 
for the buffer. It will print: 


'x' bytes allocated for data buffer. 
Data Exchange Program with Optional 
Translation 
(c) Overland Data Inc., 1983, 1984 v1.XX 
If DEPOT does not find enough memory to 
function properly, it will return to the 
Operating system after typing: 


Insufficient memory 
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Main menu. 


When DEPOT has been properly loaded and the 
data buffer area established, the main menu will 
then be presented to allow the selection of: 


1 Write a new tape 
2 Append to an existing tape 
3 Read a tape 
4 Exit to dos 
Your choice? -=-> 


Enter the number corresponding to the 
operation you want to perform. 


Translation. 


Before the_selected option can be 
executed,any desired translation must be 


indicated in response to: 
Is data conversion necessary? 


Typing a Y <RETURN> will indicate translation 
is desired. Typing any other character <RETURN> 
will be taken as a "no" and translation will not 
occur. If translation is desired, indicate the 
correct direction by responding to the following 
menu with a number <RETURN>. 


Enter: 
1 - If ASCII to EBCDIC 
2 -~ If EBCDIC to ASCII 
(1 or 2) => 


WRITING A NEW TAPE (option !). 
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This option assumes the tape mounted on the 
drive has no valid data recorded on it and will 
place the new data at the beginning of tape, 
overwriting anything previously recorded.When 
the file transfer is complete, DEPOT will write 
two file marks,rewind the tape, and return to 
the main menu. 


Disk file. 


The name of the disk file must be 
entered in response to: 


Name of file to write to tape? 
The name of the disk file is entered as: 
<[d:]filename> 

DEPOT will then search the currently logged 
disk directory for a file of that name.If the 
file is found, it will be opened for reading. 
If the file is not found, DEPOT will return to 
the main menu after printing: 


Can't open '<filename>'. 
Press return to continue... 


Tape block size. 


The size of the data blocks to write to tape 
must be indicated in response to: 


Size of data block to write to tape (x) --> 


where (x) is the maximum size allowed. 
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The data transfer will begin immediately 
after the block size is entered and will 


continue uninterrupted until the entire disk 
file has been transferred. 


NOTE: If translation is taking place, a 
little dot is printed for each tape block. 


Error recovery. 


Should an error be encountered during writing 
of the tape, DEPOT will attempt ten times to 
write the data correctly. If unsuccessful, 


An unrecoverable write error has occurred on 
tape. Press return to continue... 


Will be printed. When any key is pressed 
writing will continue until the file is 
completely written. 





APPENDING TO AN EXISTING TAPE (option 2). 


This option looks for a double file mark 
recorded on the tape and positions the recording 
head between the two file marks. It is assumed 
that there is no useful data beyond this point 
on tape, and is therefore a safe place to begin 


an append operation. 


With the exception as indicated above, the 
operation of this option is the same as that of 
writing a new tape. 


READING A TAPE (option 3). 
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This option reads the specified data from 
tape and after any required translation places 
it in the disk file. 


Locating the data. 


When the read tape option is selected, many 


additional options are available to allow only 
selected data to be transferred. Each is 


covered individually and in the order usually 
encountered. 


Number of file. 


The correct tape file is located by counting 


file marks from the beginning of tape. Provide 
this information in response to: 





Number of file marks to skip? --> 


File marks are only written at the end of a 


file transfer and never before. Therefore the 
file mark count will be one less than the number 
of the file on tape (i.e., the first file on 


tape is zero file marks from the beginning of 


tape). After skipping the required number of 
file marks, the tape is positioned to read the 


first data block in the file. 


WARNING! No check is performed to 


determine that the number is reasonable or 
that the logical end of tape is encountered, 


Blocks to skip. 
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To allow the selection of specific blocks for 
reading, DEPOT will skip any number of undesired 


blocks from the file mark. Enter the number of 
data blocks to skip in response to: 


Number of data blocks to skip? --> 


DEPOT will position the tape to read the n + 
1 data block where n is the number to skip. 


WARNING! No check is performed to 
determine that the number is reasonable or 
that a file mark or the logical end of tape 
is encountered. 


Truncation. 





Provision is made to transfer only part of a 
data block to facilitate the handling of some 
card image files. When truncation is requested, 
only a specified number of bytes of each data 
block are transferred into system memory and a 
Carriage return and a line feed are appended to 
the data in system memory before it is written 


to the disk. 
Truncate data blocks (Y/N)? --> 
When truncation is specified, the number of 
bytes to transfer must be entered in response 
to: 
Size of record to read? --> 


Disk file. 
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When reading a tape file to disk, a new file 
must be created to receive the data. 


Filename to create on disk? --> 


Enter the disk Eile name as 
<[d:]£filename> 


DEPOT searches the currently logged disk 
directory for any files with the new name and if 
one is found, DEPOT will print 


File <filename> exists. 
Overwrite? (Y/N) 
If a Y <RETURN> is typed the existing file 
will be removed and a new file created with that 


nam If ap Fee key <RETURN> is typed, DEPOT 


e. 
will cancel e file data transfer and return to 


the operating system. If for any reason the new 
file cannot be created, (i.e., full disk), DEPOT 


will return to the main menu after printing: 
Can't open '<filename>' 


Reading the tape. 


When the disk file is opened for writing, the 
method of reading the data must be specified in 
response to: | 


Select option for data read size. 
|! Read until next file mark is encountered. 


2 Read n blocks 
3 Read n bytes 


Your choice? 
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These methods are defined as: 


1. Reading and data transfer begins 
at the current tape position and continues until 
a file mark is encountered. 


| 2. Reading and data transfer begins 
at the current tape position and continues only 
until the specified number of data blocks have 
been read. 


3. Reading and data transfer begins 
at the current tape position and continues only 
until the specified number of bytes have been 
read. 


If option 2 or 3 is selected, make the 
appropriate entry in response to: 


Number of data blocks to read 
Or 


Number of bytes to read? 


ERROR CONDITIONS. 


Prior to attempting to issue any command to 
the tape drive, the drive status is checked for 
a properly loaded tape and on line status. If 
this condition is not found, notification will 
be made as: 


Place drive online. 
Press return to continue... 
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Prior to attempting to write to a tape, the 
drive status is also checked to insure that the 


tape is write enabled. If the message 


Tape is file protected, a write ring 
must be installed, and the tape reloaded. 
Press return to continue... 


is printed, install a write ring in the tape 
and reload the drive. 


In either case, the transfer operation will 


continue when any key is pressed if the error 
conditions have been corrected. 


3.8.4 Limitations 
The following are limitations that need your 
attention: 
o the maximum record size that can be 


read or written depends on where in 
memory DEPOT is loaded. 


3.9 DEPOT2 
3.9.1 Purpose (W) 


DEPOT2 provides enhancements to the original 
DEPOT utility as follows. 


3.9.2 Features (W) 
DEPOT2 adds the following features: 
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© command line execution of all 
functions | 


© command file execution allows batch 
file like operation of tape functions 


© automatic insertion of CRLF delimiters 
after each record, with user specified 
record length and block factor 


3.9.3 Use (W) 


The DEPOT2 utility makes a significant 
departure from the menu oriented style of DEPOT. 
This revised version of the original utility is/ 
no longer interactive. A degree of user 
friendliness has been eliminated to make way for 
speed of use and the convenience of command file 
operation. 





DEPOT2 is invoked from the command line. Any 
desired tape operation can be specified by 
including the proper switch options on the 
command line. Sequences of tape operations may 
be created by making a disk text file, (using 
any available editor), containing one line of 
switch options for each tape operation desired. 


Find a blank tape, insert a write enable ring 
in the back of the tape reel, and load it onto 
the tape transport. Note: this procedure will 
write onto the tape, so make sure the tape you 
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ha thi : pari ‘tt ee 
When the tape is loaded, place the transport 
online. 


The command line will contain a variety of 
Switch options, which define the details of the 
Operation to follow. The following list 
describes the syntax and purpose of each option: 


/c name command filename: looks to this 
file for all of the following 
functions if present, and ignores 
all other switches on command line. 


/t translate: implies to ascii for tape 
read and to ebcidc for tape write. 





/n name file name for disk i/o 

/rx val record size 

/b val block factor 

/s val block size 

/V give running commentary 

/i ignore errors (but print 
error messages) 

/N NRZI tape (used only with 
TC~-PC) 

/m val number of file marks to skip 

/da val number of data blocks to 
skip 
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Ja append to existing tape 

/w write a new tape 

/B val number of data blocks to 
read 

/R val number of records to read 

/M read until file mark is 
reached 

/p set bit 7 to zero 


HOW TO USE THE COMMAND LINE 


We will provide two primary examples of 
DEPOT2 use; writing to poe and reading from 
tape. To write, we specify the /w switch, 
indicating writing from the beginning of the 
tape. The /v switch should be used any time a 
new operation is specified, to cause the program 


to display all options specified. This will 
help verify the program is oe ad what we expect. 
During any tape operation, a filename must be 


specified. Use the /n switch to specify a 
desired filename. Be sure to put a space 


between the "n" and the filename. So far our 
command ee Pooks like Edts! 





DEPOT2 /wv /n bigfile 


Before writing to tape, the size of the data 
block to be written must be specified. The /s 
option directly specifies the data block size. 
With this option in use, the data being read 
from disk is not altered in any way prior to 
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being written to tape. The complete command 
line, indicating 19008 byte data blocks, looks 


like this: 
DEPOT2 /wv /n bigfile /s 1999 


Another important method for specifying block 
size uses the /b and /r switches. With these 
Switches, you may specify record length and 
blocking factor. Assume for a moment that you 
have an ASCII text file which contains lines of 
text of varying length (the READ.ME file is a 
good example). Each line of the file is 
considered to be a record for the purposes of 
DEPOT2. The value following the /r switch 
indicates the size of each record to be written 
to tape. Any record read from disk that exceeds 
this value will be truncated. Any record read 
from disk that is found to be shorter than this 
value will have space characters added to the 
end of the record, filling it out to the size 
specified by value. In all cases, the carriage 
return/line feed sequence normally found at the 
end of a disk record will be removed. The 
number of these records (lines) to be written to 
each data block constitutes the blocking factor. 
The size of the data block then becomes the 
record length multiplied by the block factor. A 
command line specifying record length of 89 
bytes and block factor of 598 will look like 
thiss 


DEPOT2 /wv /n bigfile /r 88 /b 50 
To read the first example shown above 


requires only that we indicate to the program 
when to stop reading. Stopping on a filemark 
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will be suitable, as filemarks are generally 
used to indicate the end of a file. The entire 
command line will then look like this: 


DEPOT2 /vM /n newfile 


There is no switch to directly indicate a 
read operation. The absence of either the /w or 
fa switch defaults to the read operation. The 
/M switch will cause the read operation to cease 
on encountering a filemark. 


To read the second example we Simply add the 
record size and block factor switches to the 
command line as follows: 


DEPOT2 /vM /n newfile /r 88 /b 58 


This will cause the program to add carriage 
return/line feed sequences to the data after 
each 8@ bytes, and insures that each data block 
is an even multiple of the record size in 
length. 


; This is a sample command file that 
illustrates ; how multiple tape operations may 
be specified ; for repetitive tasks. Please note 
that comment ; lines MUST begin with a 
semi-colon in the 
¢ FIRST column of text. 


Write read.me file with fixed length records, 
5@ per block. The "w" switch indicates writing 
from the beginning of the tape. 

/wy /r78 /b56 /n read.me 


=e we BRO 


Write it again as a straight image. The 


me 
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remaining write operations are specified with 
an "a" switch set to append these files to the 
existing data on tape. 

J/Jav /s 1000 /n read.me 


Write it this time with short records, 


truncating lines. 
fav /r49 /b5@ /n read.me 


Write it this time with long records, and 
larger block factor. 
J/av /r128 /b109 /n read.me 


Write it again with short records, and smaller 
block factor. 
Jav /r40 /b38 /n read.me 


Write one last time in EBCDIC, with 89 byte 
records and short blocks 
/avt /r 88 /b 10 /n read.me 


Read the first file, deblock it and write it 
back to disk. Stop when a file mark is 
reached. 

/vVM /r78 /b58 /n test 


Read and reproduce the straight image. 
/vM /n test! /m 1 


Read file written with truncated lines, but 
only the first thirty lines. 
/v /r 48 /b 38 /m 4 /n test2 /R 36 


Read the first file, deblock it and write it 
back to disk. This time stop after reading 
only one data block. 

/v /r78 /b50 /n test3 /B 1 
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Read the EBCDIC version. Note that if you use 
the DOS TYPE command to examine this file, it 
will appear to be double-spaced, due to the 
auto-wrap function of the display. Viewing 
the file with a text editor will eliminate 


this illusion. 
/veM /r89 /b18 /m5 /n test4 


" ™—e %O we RO WE Be 


3.9.4 Limitations (W) 


The following are limitations that need your 
attention: 





o DEPOT2 is limited to a 64K block size 


3.18 What 
3.19.1 Purpose (W) 

The purpose of the WHAT program is to 
determine which source code modules you have in 
your software. In the event that you have any 


software problems, this will aid us in 
identifying and resolving then. 


3.19.2 Use (W) 


To use the WHAT program, type: 





what filename filename etc, 
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at the command prompt. WHAT can use DOS 
wildcards such as "*.*" or "*,exe". Here iS a 


sample of usage and results. 


A> what bakup.exe 


bakup.c 1.2 4-3-85 
ftape.c 1.5 6-13-85 
allmem.c 1.2 6-18-85 


This tells us exactly which software 
modules you are working with. From here we can 
determine if your problem has been resolved in a 
more recent release, or is unique, requiring 
immediate modification. 





3.19.3 Limitations (W) 


The WHAT program has the following 
limitation: 


O WHAT.EXE will (currently) only work 
with software from OVERLAND DATA INC. 


3.11 See Depot2 for CMD (E) 
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4 Appendices 
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4.1 Controller I/O Map 
- TAPE CONTROLLER I/O MAP - 


Default base port address as shipped 36ch 
PORT INPUT 


36CH CONTROLLER STATUS WORD A 

36DH CONTROLLER STATUS WORD B 

36EH N/A 

PORT OUTPUT 

36CH TAPE IGO AND COMMAND WORD 

36DH TAPE ADDRESS AND MISC. COMMANDS 
36EH SETS DMA REQUEST LATCH 


For further information refer to the data sheet 
on the Intel 8237. 


STATUS BIT MAP 


BYTE B-> BIT 15 BIT 14 BIT 13 BIT 12 


EOTL ~ OVF TLNG DBYL 
BIT 11 BIT 18 BIT 9 BIT 8 
RWD FMK CER HER 


BYTE A-> BIT 7 BIT 6 BIT 5 BIT 4 
EOT BOT SPD ONL 


BIT 3 BIT 2 BIT 1 BIT BO 
FPT RDY DBSY FBSY 


OUTPUT BIT MAP 
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COMMAND PORT 36CH 


BIT 5 BIT 4 BIT 3 BIT 2 BIT 1 BIT @ 
FAST ERASE EDIT WFM WRT REV 


The IGO pulse is generated during any write to 
port 36ch. 


PORT 36Dh 
Tape selection and non data control 


BIT 7 BIT 6 BIT 5 BIT 4 
W/R* DMA-EN FAD TAD! 


BIT 3 BIT 2 BIT 1 BIT 9 
TADS REW FEN RW/U 


USER OPTIONS 


BOARD ADDRESSING 
The TC-PC controller occupies four 


consecutive I/O locations. An 8 position switch 
allows the board to be addressed on any ‘four 


byte boundary within the 10824 byte address range 
of the IBM PC. Switches set to the on position 

represent a logic @, set to off, a logic |. The 
following illustration shows the board addressed 


as shipped. 
Address A9 A8 A7- AG AS A4 A3_ A2 


Switch 8 7 6 5 4 3 2 l 
set to OFF OFF ON OFF OFF ON OFF OFF 


Binary 1 J Y) ] l 9 1 I 
Hexadecimal ~~ 36C 
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DMA CHANNEL “J 

The board operates using DMA channel |! as 
Shipped. To enable operation using other 
channels, jumper as follows. 


Channel no. Pin pairs to shunt 
U,V 
2 Y,J 
3 W,X 


>> CAUTION !! << Channel 2 operation is 
not advised as this channel is used by the IBM 
floppy disk controller. 


INTERRUPTS 

Interrupts may be generated upon completion 
of any data transfer command. The current 
software does not support interrupts. To enable 
interrupts, shunt one of the following pin 
pairs. Interrupts will be generated only when 
Data Busy goes false. Writing to the command 
port will reset this interrupt. 


IRQ2 
IRQ3 
IRQ4 
IRQ5 
IRQ6 
IRQ7 


HMBASrnAN 


Tape Status Inputs 


Input Port n4: Status Byte A 
Bit 9 IFBY-~Formatter Busy: Indicates the 


formatter is busy executing a data 
type command (i.e.: not Rewind) and 
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other tape drive addressing may not 
be done and, in the absence of a 


IDBY transition to @, may not be 
issued another command. 


Bit 1 IDBY--Data Busy: Indicates the 
formatter is busy and that data is 
likely to be transferred. The DMA 
may be active during this time. 


Bit 2 IRDY--Ready: This is true whenever 
the addressed drive is Online, 
Selected, Loaded, and not rewinding. 
All commands should be precon- 
ditioned on this status. 


Bit 3 IFPT--File Protected: The drive is 
file protected and may not be 
written to. A write command will 
have either no effect or cause the 
drive to stop with a fault code. 





Bit 4 IONL--Online: The drive is online 
and tape is loaded. The drive may 
be placed offline from its front 


panel. 

Bit 5 ISPD--Speed: This status is true if 
the last command ws executed at high 
speed. 

Bit 6 IBOT--Beginning of Tape: This 


status is true if the tape is 
positioned at the start of tape. 
This is normally true only after a 
rewind or tape loading operation. 
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Bit 7 


TEOT--End of Tape: This status is 
true whenever the tape reaches the 
EOT marker. This does not terminate 
tape operations; indeed, the 
allowable recording surface extends 
another 18 feet. 


Tape Status Inputs 


Input Port n5: Status Byte 


Bit @ 
Bit 1 
Bit 2 
Bit 3 
Bit 4 


IHER--Hard Error: This bit is set 
if the previous read command 
transferred uncorrectable data. 


ICER--Correctable Error: This bit 

is set when a Single track failed 

but the drive electronics was able to 
correctly copy data. 


IFMK--File Mark Detected. The last 
command completed with a file mark 
sensed. When a file mark sense 
occurs, there is no data transfer 
uSing a 1688 bpi tape drive. 


*IRWD--If 9, the tape drive is 
rewinding. The drive may not be 
commanded until rewinding is 
complete. 


IDBY--Transition False: This 
Signifies that IDBY has transitioned 
false. This is especially useful 
for detecting the completion of a 
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command without waiting for the -IFBY 
to go false. 

Bits 68-4 All status bits are held until the 
next B command is issued to port n5. 
Since the information retained in 
this port must be saved in memory, 
this provides a convenient way to 
initialize status. 


OUTPUT TAPE COMMANDS 


PORT: n4 = Tape IGO Command 


Bits 9- Tape function command. 





Read forward 

Read reverse 

Read reverse edit 
Write block 
Overwrite 

Write file mark 


OrnNywo—e © 


' Brase variable block 
Erase fixed 
Security erase 


a= eed Ob 


Skip forward block 
Skip reverse block 


— SB CH ov NO 


ean ent 


Skip forward file (no read data) 
Skip reverse file (no read data) 


UT > 


© 


No operation 
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IC Select 1699 BPI 
ID Select 32909 BPI 


Bit 5 Tape speed control (@ = 25 
ips, 1 = 188 ips) 


OUTPUT TAPE COMMANDS 


PORT: n5 = Tape selection and non data control 
Bit 9 IRWU--Rewind and Unload: 


Bit 1 IFEN--*Clear formatter: This line 
should normally be asserted but may 
be pulsed false clear a drive 
runaway such as a read command on 
erased tape. 





Bit 2 IREW--Rewind to beginning of tape: 
The tape rewinds to beginning of 


tape. 
Bit 3 ITAD9--Drive select LSB. 
Bit 4 ITADI-—-Drive select. 
Bit 5 IFAD--Drive select MSB. 


Note |: This signal should be formed by 
outputting to port n5 the desired word with 
the selected bit set. The port should then 
be output with the selected bit reset. 





Depot2 Quick Reference Guide 
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/c 


/t 


/n 


/b 


fs 


/V 
Ji 


/N 


/m 
/a 


fa 
/w 
/B 


/R 


name command filename: looks to this 


file for all of the following 
functions if present, and ignores 
all other switches on command line. 


translate: implies to ascii fo, tape 
read and to ebcide for tape write. 


name 


val 


val 


val 


val 


val 


val 


val 


file name for disk i/o. 


record size 


block factor 


block size 


give running commentary 


ignore errors (but print 
error messages) 


NRZI tape (used only 
TC-PC) 


number of file marks to skip 


number of data blocks to 
skip 


append to existing tape 


write a new tape 


number of data blocks to 
read . 


number of records to read 
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/M read until file mark is 
reached _ 


/P set bit 7 to zero 
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4.3 Drive Interface Pinout 
‘APE DRIVE INTERFACE PINOUT 


Here follows the board I/O connections 
arranged by pin number. 





J1—2 IFBY J2-2 IRDO 
J1-4 ILWD J2-3 IRD] 
J1-6 IWR4 J2-4 IBOT 
J1-8 IGO J2-6 IRD4 
J1-19 IWRO J2-8 IRD7 
J1i-12 IWRI J2-10 IRD6 
J1-18 IREV J2-12 IHER 
J1-26 IREW J2-14 IFMK 
J1-24 IWR7 _ J2-18 IFEN 
J1-26 IWR3 J2~-29 IRD5 
J1-28 IWR6 J2-22 LTEOT 
J1-39 IWR2 J2-24 TRW/U 
J1-32 IWR5 J2-28 IRDY 
J1-34 IWRT J2-39 IRWD 
J1-38 LIEDIT J2=-32 IFPT 
J1-49 ITERASE J2-34 IRDCLK 
J1-42 IWFM J2-36 IWRCLK 
J1-46 ITADO J2-38 IDBY 
J1-48 IRD2 J2-49 ISPD 
J1-59 IRD3 J2-42 ICER 
J2~-44 ITONL 
J2-46 ITAD! 
J2-48 IFAD 
J2-59 IFAST 


Here follows the board I/O connections 
arranged alphabetically. 
IBOT J2—-4 IRD! J2-3 
ICER J2-42 IRDG J2-2 
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IDBY 
IEDIT 
IEOT 


ITERASE 


IFAD 
IFAST 
IFBY 
IFEN 
IFMK 
IFPT 
IGO 
IHER 
ILWD 
IONL 
IRD7 
IRD6 
IRD5 
IRD4 
IRD3 
IRD2 


J2-38 
Ji-38 
J2-22 
J1-49 
J2-48 
J2-50 
JI-2 

J2-18 
J2-14 
J2-32 
J1-8 

J2-12 
J1-4 

J2-44 
J2-8 

J2-19 
J2-29 
J2-6 

J1-59 
J1-48 
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IRDCLK 
‘ERDY 


LTREV 
LREW 
IRW/U 
IRWD. 
ISPD 
ITADO 
ITAD] 
IWFM 
IWR7 
IWR6 
IWR5 
IWR4 
IWR3 
IWR2 
IWRI 
IWROD 


IWRCLK 


IWRT 


J2-34 
J2-28 
J1i-18 
J1-29 
J2—-24 
J2-39 
J2-49 
J1-46 
J2-46 
J1-42 
J1-24 
J1-28 
J1-32 
J1-6 
J1-26 
J1-39 
Ji-12 
JI-18 
J2-36 
J1-34 
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4.4 Warranty 
LIMITED WARRANTY 


OVERLAND DATA INC. warrants to the original 


purchaser of this OVERLAND DATA INC. product 

that it is to be in good working order for a 

Bence of one year from the date of purchase 
rom OVERLAND DATA INC. or an authorized 


OVERLAND DATA INC. dealer. Should this product 
in OVERLAND DATA's opinion, malfunction during 
the warranty period, OVERLAND DATA INC. will, 
at its option, repair or replace it at no 
charge, provided that the product has not been 
subjected to misuse, abuse, or non-OVERLAND 
DATA INC. authorized alterations, 
modifications, and/or repairs. 





Products requiring Limited Warranty service 
during the warranty period should be delivered 
to OVERLAND DATA INC. with proof of purchase. 

If the delivery is by mail, you agree to insure 
the product or assume the risk of loss or damage 
in transit, You also agree to prepay shipping 
charges to OVERLAND DATA INC.. 


ALL EXPRESS AND IMPLIED WARRANTIES FOR THIS 
PRODUCT INCLUDING, BUT NOT LIMITED TO, THE 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, ARE LIMITED IN DURATION TO 
THE ABOVE ONE YEAR PERIOD.Some states do not 
allow limitations on how long an implied 
warranty lasts, so the above limitations may not 
apply to you. 


UNDER NO CIRCUMSTANCES WILL OVERLAND DATA 
INC. BE LIABLE IN ANY WAY TO THE USER FOR 
DAMAGES, INCLUDING ANY LOST PROFITS,LOST 
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SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL 
DAMAGES ARISING OUT OF THE USE OF OR INABILITY 
TO USE, SUCH PRODUCT. Some states do not allow 
the exclusion or limitation of incidental or 
consequential damages for consumer products, so 
the above limitations or exclusion may not apply 
to you. 


THIS WARRANTY GIVES YOU SPECIFIC LEGAL 
RIGHTS, AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH 
MAY VARY FROM STATE TO STATE. 


The limited warranty applies to hardware 
products only. 
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4.5 Customer Response Form 
OVERLAND DATA INC, 
Customer Response Form 


TC-PC user manual 


We appreciate your comments regarding any 
problems or suggestions related to OVERLAND DATA 
INC. products. Please use this form to send any 
thoughts or ideas that you have with regard to 
improvements of the documentation, or the 
OVERLAND DATA INC. product line. 

SUBMITTER INFOMATION: 


SUBMITTER'S NAME: 
ADDRESS: 





COMMENTS : 


Please remit to : OVERLAND DATA INC. 
5644 Kearny Mesa Rd. Ste. A 
San Diego,Ca. 92111 
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